home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SPACE 2
/
SPACE - Library 2 - Volume 1.iso
/
music
/
204a
/
playit.txt
< prev
Wrap
Text File
|
1988-04-01
|
10KB
|
208 lines
#########################################################################
AutoPlay, PLAYIT & PlayEdit
{ST Replay sound file player & Degas Pic shower}
by David R. Sullivan
4156 Tolowa Street
San Diego, CA 92117
San Diego Atari Computer Enthusiasts
ST-SDACE BBS (619)284-3821 2400/1200/300 baud
SDACE-8 BBS (619)566-3430 1200/300 baud
#########################################################################
This Program is SHAREWARE,
it is not to be placed on CompuServe,
please contribute if you use this program.
#########################################################################
You have obviously just unARCed the file PLAYIT.ARC. The files you
should now have are:
AUTOPLAY.PRG (Plays sound files from an AUTO folder)
BASCODE.EXE (Michtron's GFA Basic "player" code)
PLAYEDIT.PRG (Change .SPL files into .SND files)
PLAYIT.PRG ("Click" and play .SND files)
PLAYIT.TXT (The file you are reading)
NOTE: The file BASCODE.EXE must be in the same folder or "root" directory
as ANY of the PLAYIT programs (AUTOPLAY.PRG, PLAYEDIT.PRG & PLAYIT.PRG).
All programs were written in GFA BASIC and compiled with the GFA COMPILER
from Michtron. These programs are intended to be used to play back sound
files created with ST REPLAY sound digitizer, also from Michtron.
=========================================================================
PLAYEDIT.PRG (AutoPlay Editor)
=========================================================================
Raw sound files generated by Michtron's ST REPLAY are saved without any
"speed" data in the file. Thus, each time you use ST Replay's software
to play back a sound file you must manually "set" the playback speed.
To be able to just "click and play" sound files required the need to
include some "speed" data in the sound file. Thus, PLAYEDIT was born.
PLAYEDIT allows you to load in raw digitized .SPL sound files and save
them with the proper "speed" included as a .SND file. PLAYIT is
designed to only play back these "modified" .SND files.
When using PLAYEDIT to modify a .SPL file a single byte is added to the
file in it's conversion to a .SND file. That is all there is to it.
For those who wish to revert back to ST Replay, do not worry. The extra
byte at the front of the .SND file is virtually ignored by ST Replay.
Just rename the file back to a .SPL file. It is not good, however, to
continue to convert to .SND files and then rename back to .SPL files, a
buildup of SPEED BYTES will cause some interesting results (unpredictable
sounds).
=========================================================================
PLAYIT.PRG ("Click and Play" .SND file player)
=========================================================================
PLAYIT is a simple "click and play" sound file player. Again, PLAYIT
only plays .SND sound files that have been modified with PLAYEDIT.
=========================================================================
AUTOPLAY.PRG (Play those sound files at boot-up)
=========================================================================
AUTOPLAY will allow you to play and manipulate sound files (.SPL or .SND)
while manipulating DEGAS/NEOchrome pictures. AUTOPLAY uses a script
file to interpret what you want it to do. AUTOPLAY can (as the name
suggests) be used from an AUTO folder, it may also be used from any
other folder or directory.
It should be noted that a script file is NOT required to use AUTOPLAY.
When AUTOPLAY is run (whether from an AUTO folder or from the desktop)
it looks for a script file in the same "directory" that it is in.
If no script file is found, AUTOPLAY will simply load the first DEGAS/NEO
pic it runs into (if one exists) and then load and play the first .SND
file that it runs into. AUTOPLAY will NOT play .SPL files without a
script file.
This makes AUTOPLAY easy to use without having to create a script file.
Simply convert your favorite .SPL file to a .SND file using PLAYEDIT and
place the .SND file into your AUTO folder on your boot disk along with
AUTOPLAY.PRG, BASCODE.EXE and any favorite PIC you may have.
The Commands available in AUTOPLAY's script files are as follows:
-------------------------------------------------------------------------
Command Example Comment
-------------------------------------------------------------------------
REPEAT /REPEAT 10 Repeat Script File (up to current
command) 10 times
BUFFER /BUFFER=2 Set Default Buffer to 2
/# There are five Buffers 0 to 4,
Five for Sound and five for Picture
BUFFER PLAY will set default buffer
here, then execute sound later
SPEED /SPEED=2 Set Sound Sampling Speed to 2
in current buffer
LOAD ONLY /LOAD ONLY Load Data into buffer, do not
view or play data
VIEW View data in default buffer
BUFFER VIEW /BUFFER VIEW 1 View data in buffer 1
SCROLL UP /SCROLL UP Scroll default buffer screen up
onto screen
SCROLL DOWN /SCROLL DOWN Scroll default buffer screen down
onto screen
PLAY /PLAY Play sound in default buffer
BUFFER PLAY /BUFFER PLAY 1 Play sound in buffer 1
SOUND /SOUND 1~2~3~4~5 Equal to GFA BASIC's Sound 1,2,3,4,5
DELAY /DELAY 19 Delay 19/60th of a second
CLEAR /CLEAR Clear Screen
RES /RES=1 Change to Medium Resolution
0=Low, 1=Medium, 2=High (resets ST)
GOTO /GOTO 12 GOTO line number 12
GOSUB /GOSUB 50 GOSUB line number 50
RETURN /RETURN Return to last calling point
(Exit a GOSUB)
PRINT /PRINT HELLO Prints HELLO to the screen, the
print command must be last on a
line
LOCATE /LOCATE 1~2 Set the new cursor position to 1,2
END /END Terminates script file
-------------------------------------------------------------------------
General Line Formats:
-------------------------------------------------------------------------
[filespec]/COMMAND[/COMMAND][/COMMAND]...
filespec /SPEED=2
filespec /LOAD ONLY /SCROLL DOWN
filespec /LOAD ONLY
-------------------------------------------------------------------------
Warning, all commands are interpreted in order as listed above,
regardless of what position they are passed in. The file(s) are loaded
after the LOAD ONLY command has been searched for.
The Command LOAD ONLY is only useful when use along with a file-
spec. In all other cases it is ignored.
The filespec command is used to read Sound files and Picture files
from the Disk. When specified the system will look for the following
files:
filespec.SND An AutoPlay sound file, with speed control
filespec.SPL An untouched ST Replay sound file, default speed is 2
filespec.PIx DEGAS picture, x is the current resolution
filespec.NEO NEOchrome picture, loaded in LOW RESOLUTION only
When a file is found it will be loaded. If no other parameters are
passed that file will be displayed on the screen or played as a sound
file.
It is best to keep ONE COMMAND per line, or aleast as few as
possible. Since all commands are interpreted in a set order, you may
place them anywhere on the line, after the filespec. Be sure to place
a space character after the filespec so that the system knows where the
end of the filespec is.
To trace a script file as it is executed hold down the right
mouse button while the AUTOPLAY is loaded. The Incoming information
will be displayed followed by the filename interpreted by AUTOPLAY.
If you continue to hold the right button, AUTOPLAY will stop at
each command and wait for you to click the left button (while the
right is being held down). In trace; NUM: is the buffer number
being accessed, DAT: is the buffer area, SPD: is the current sound
speed and LEN: is the length of the sound.
-------------------------------------------------------------------------
Example Script File
-------------------------------------------------------------------------
EXAMPLE SCRIPT FILE COMMENT
/PICTURE0 /LOAD ONLY /BUFFER=0 LOAD PICTURE0 INTO P-BUFFER0
/PICTURE1 /BUFFER=1 LOAD PICTURE1 INTO P-BUFFER1 & DISPLAY
/PICTURE2 /LOAD ONLY /BUFFER=2 LOAD PICTURE2 INTO P-BUFFER2
/PICTURE3 /LOAD ONLY /BUFFER=3 LOAD PICTURE3 INTO P-BUFFER3
/SOUND1 /LOAD ONLY /BUFFER=1 LOAD SOUND1 INTO S-BUFFER1
/SOUND2 /LOAD ONLY /BUFFER=2 LOAD SOUND2 INTO S-BUFFER2
/BUFFER VIEW 2 DISPLAY PICTURE 2
/BUFFER PLAY 1 PLAY SOUND 1
/BUFFER VIEW 3 DISPLAY PICTURE 3
/BUFFER PLAY 2 PLAY SOUND 2
/REPEAT 10 REPEAT TEN TIMES
/BUFFER=0 SET DEFAULT BUFFER TO 0
/SCROLL DOWN SCRIPT PICTURE 0 DOWN ON THE SCREEN
-------------------------------------------------------------------------
The file PERFECT.SND (also included in this ARC file) makes a nice
"StartUp" sound file. Give it a try!